home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / ifl / TIFFtile.z / TIFFtile
Encoding:
Text File  |  1998-10-20  |  6.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. TTTTIIIIFFFFFFFFTTTTIIIILLLLEEEE((((3333TTTT))))      IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll       TTTTIIIIFFFFFFFFTTTTIIIILLLLEEEE((((3333TTTT))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      TIFFTileSize, TIFFTileRowSize, TIFFVTileSize, TIFFDefaultTileSize,
  10.      TIFFComputeTile, TIFFCheckTile, TIFFNumberOfTiles - tile-related utility
  11.      routines
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ttttiiiiffffffffiiiioooo....hhhh>>>>
  15.      vvvvooooiiiidddd TTTTIIIIFFFFFFFFDDDDeeeeffffaaaauuuullllttttTTTTiiiilllleeeeSSSSiiiizzzzeeee((((TTTTIIIIFFFFFFFF**** ttttiiiiffff,,,, uuuuiiiinnnntttt33332222**** ttttwwww,,,, uuuuiiiinnnntttt33332222**** tttthhhh))))
  16.      ttttssssiiiizzzzeeee____tttt TTTTIIIIFFFFFFFFTTTTiiiilllleeeeSSSSiiiizzzzeeee((((TTTTIIIIFFFFFFFF**** ttttiiiiffff))))
  17.      ttttssssiiiizzzzeeee____tttt TTTTIIIIFFFFFFFFTTTTiiiilllleeeeRRRRoooowwwwSSSSiiiizzzzeeee((((TTTTIIIIFFFFFFFF**** ttttiiiiffff))))
  18.      ttttssssiiiizzzzeeee____tttt TTTTIIIIFFFFFFFFVVVVTTTTiiiilllleeeeSSSSiiiizzzzeeee((((TTTTIIIIFFFFFFFF**** ttttiiiiffff,,,, uuuuiiiinnnntttt33332222 nnnnrrrroooowwwwssss))))
  19.      ttttttttiiiilllleeee____tttt TTTTIIIIFFFFFFFFCCCCoooommmmppppuuuutttteeeeTTTTiiiilllleeee((((TTTTIIIIFFFFFFFF**** ttttiiiiffff,,,, uuuuiiiinnnntttt33332222 xxxx,,,, uuuuiiiinnnntttt33332222 yyyy,,,, uuuuiiiinnnntttt33332222 zzzz,,,, ttttssssaaaammmmpppplllleeee____tttt ssssaaaammmmpppplllleeee))))
  20.      iiiinnnntttt TTTTIIIIFFFFFFFFCCCChhhheeeecccckkkkTTTTiiiilllleeee((((TTTTIIIIFFFFFFFF**** ttttiiiiffff,,,, uuuuiiiinnnntttt33332222 xxxx,,,, uuuuiiiinnnntttt33332222 yyyy,,,, uuuuiiiinnnntttt33332222 zzzz,,,, ttttssssaaaammmmpppplllleeee____tttt ssssaaaammmmpppplllleeee))))
  21.      ttttttttiiiilllleeee____tttt TTTTIIIIFFFFFFFFNNNNuuuummmmbbbbeeeerrrrOOOOffffTTTTiiiilllleeeessss((((TTTTIIIIFFFFFFFF**** ttttiiiiffff))))
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.      _T_I_F_F_D_e_f_a_u_l_t_T_i_l_e_S_i_z_e returns the pixel width and height of a reasonable-
  25.      sized tile; suitable for setting up the _T_i_l_e_W_i_d_t_h and _T_i_l_e_L_e_n_g_t_h tags.
  26.      If the _t_w and _t_h values passed in are non-zero, then they are adjusted to
  27.      reflect any compression-specific requirements.  The returned width and
  28.      height are constrained to be a multiple of 16 pixels to conform with the
  29.      TIFF specification.
  30.  
  31.      _T_I_F_F_T_i_l_e_S_i_z_e returns the equivalent size for a tile of data as it would
  32.      be returned in a call to _T_I_F_F_R_e_a_d_T_i_l_e or as it would be expected in a
  33.      call to _T_I_F_F_W_r_i_t_e_T_i_l_e.
  34.  
  35.      _T_I_F_F_V_T_i_l_e_S_i_z_e returns the number of bytes in a row-aligned tile with
  36.      _n_r_o_w_s of data.
  37.  
  38.      _T_I_F_F_T_i_l_e_R_o_w_S_i_z_e returns the number of bytes of a row of data in a tile.
  39.  
  40.      _T_I_F_F_C_o_m_p_u_t_e_T_i_l_e returns the tile that contains the specified coordinates.
  41.      A valid tile is always returned; out-of-range coordinate values are
  42.      clamped to the bounds of the image.  The _x and _y parameters are always
  43.      used in calculating a tile.  The _z parameter is used if the image is
  44.      deeper than 1 slice (_I_m_a_g_e_D_e_p_t_h>1).  The _s_a_m_p_l_e parameter is used only if
  45.      data are organized in separate planes (_P_l_a_n_a_r_C_o_n_f_i_g_u_r_a_t_i_o_n=2).
  46.  
  47.      _T_I_F_F_C_h_e_c_k_T_i_l_e returns a non-zero value if the supplied coordinates are
  48.      within the bounds of the image and zero otherwise.  The _x parameter is
  49.      checked against the value of the _I_m_a_g_e_W_i_d_t_h tag.  The _y parameter is
  50.      checked against the value of the _I_m_a_g_e_L_e_n_g_t_h tag.  The _z parameter is
  51.      checked against the value of the _I_m_a_g_e_D_e_p_t_h tag (if defined).  The _s_a_m_p_l_e
  52.      parameter is checked against the value of the _S_a_m_p_l_e_s_P_e_r_P_i_x_e_l parameter
  53.      if the data are organized in separate planes.
  54.  
  55.      _T_I_F_F_N_u_m_b_e_r_O_f_T_i_l_e_s returns the number of tiles in the image.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TTTTIIIIFFFFFFFFTTTTIIIILLLLEEEE((((3333TTTT))))      IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll       TTTTIIIIFFFFFFFFTTTTIIIILLLLEEEE((((3333TTTT))))
  71.  
  72.  
  73.  
  74. DIAGNOSTICS
  75.      None.
  76.  
  77. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  78.      _l_i_b_t_i_f_f(3T), _T_I_F_F_R_e_a_d_E_n_c_o_d_e_d_T_i_l_e(3T), _T_I_F_F_R_e_a_d_R_a_w_T_i_l_e(3T),
  79.      _T_I_F_F_R_e_a_d_T_i_l_e(3T), _T_I_F_F_W_r_i_t_e_E_n_c_o_d_e_d_T_i_l_e(3T), _T_I_F_F_W_r_i_t_e_R_a_w_T_i_l_e(3T),
  80.      _T_I_F_F_W_r_i_t_e_T_i_l_e(3T)
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.